home *** CD-ROM | disk | FTP | other *** search
/ Games of Daze / Infomagic - Games of Daze (Summer 1995) (Disc 1 of 2).iso / djgpp / readme < prev    next >
Encoding:
Text File  |  1995-03-23  |  5.0 KB  |  136 lines
  1. ===============================================================================
  2.                           Ladybug version 1.00
  3. ===============================================================================
  4.  
  5. -------------------------------------------------------------------------------
  6. 1 Installation
  7.  
  8. NOTE: $DJGPP means your djgpp directory, for example, C:\DJGPP.
  9.  
  10.   - In the $DJGPP directory, unzip the file ldgb100.zip, like so:
  11.     (for pkzip, the invocation is pkunzip -d -o ldbg100).  Be sure
  12.     your unzip utility preserves the directory information stored
  13.     in the zip file.
  14.  
  15.   - Copy the files ladybug and ladydpmi from $DJGPP/go32/fs to
  16.     $DJGPP/bin.
  17.  
  18.   - IMPORTANT: If this is the FIRST time you are using Ladybug version
  19.     1.00, make sure that you read Sections 2 and 3 of this document
  20.     before continuing!!!!
  21.  
  22.   - After setting up the LDBG environment variable (as outlined in
  23.     Sections 2 and 3), reboot your computer.
  24.  
  25. 2. Environment
  26.  
  27. Ladybug uses a environment variable named LDBG.  The syntax for
  28. setting this environment variable is as follows:
  29.  
  30. set LDBG=value [value ...]
  31.  
  32. where value can be one of:
  33.  
  34. value                 meaning
  35. ---------------------------------------------------------------
  36. oldgo32               The current go32 does not support remote
  37.                       debugging.  Don't check for the remote
  38.                       debugging command line switch.
  39. remote <com_num>      Use com port number <com_num> to do remote
  40.                       debugging.  <com_num> is a number from 1 to 4.
  41. sympath <path>        Use <path> as the path to the symbol file.
  42.                       The default path is the path to the program
  43.                       being debugged.
  44. symname <name>        Use <name> for symbol file.  The default is
  45.                       the name of the program being debugged.
  46. symext <ext>          Use <ext> as symbol file's extension. 
  47.                       The default extension is ".sym".
  48.  
  49. If you are not using a version of go32 that supports remote debugging
  50. (the only known versions that do are 1.11maint5n and 1.12maint3)
  51. or if you are not sure if your copy of go32 supports this feature,
  52. add the following into your autoexec.bat file:
  53.  
  54.   set LDBG=oldgo32
  55.  
  56. If you wish to do remote debugging with LDBG set to oldgo32, then
  57. add the following to your autoexec.bat file:
  58.  
  59.   set LDBG=oldgo32 remote <com_num>
  60.  
  61. where <com_num> is the com port number as described above.
  62.  
  63. EXAMPLE:
  64.  
  65.   set LDBG=oldgo32 sympath /djgpp/syms symext sym
  66.  
  67. which tells Ladybug to use the file
  68.  
  69.   /djgpp/syms/<program_name>.sym
  70.  
  71. as the symbol file for
  72.  
  73.   <program_name>.<whatever>
  74.  
  75. -------------------------------------------------------------------------------
  76. 3. Symbol file
  77.  
  78. In order to conserve memory, Ladybug stores symbol information in
  79. a .sym file and reads from the file as necessary.  The name of the
  80. file is the same as the name of the program being debugged,
  81. e.g. program.exe will typically accompany a program.sym file 
  82. which contains symbol information.
  83.  
  84. Ladybug uses timestamp and size information in order to determine if
  85. the .sym file contains the actual symbol information belonging to the
  86. target program being debugged.  However, Ladybug WILL be fooled if
  87. the number of symbols in the target program corresponds to the
  88. number of symbols in the .sym file AND the timestamp of the program
  89. file corresponds to the information stored in the .sym file.  This
  90. is unlikely, but be careful when "touching" the program file.  To
  91. be safe, delete the .sym file every time you recompile.
  92.  
  93. If reading the symbol file takes too long, defragment the file and
  94. restart Ladybug.
  95.  
  96. To change the symbol file name, see Section 2 above.
  97.  
  98. Any file (other than the symbol file itself) that has the same path,
  99. name, and extension as the symbol file WILL be OVERWRITTEN,
  100. therefore it is probably a good idea to set the symbol path to a
  101. seperate symbol directory (like /djgpp/syms) as outlined in Section 2
  102. above.
  103.  
  104. Ladybug will not delete the symbol file for you.  If you need more
  105. disk space, delete it yourself.
  106.  
  107. ------------------------------------------------------------------------------
  108. 4. Running Ladybug
  109.  
  110.   Start Ladybug as you would normally start up the djgpp's debugger:
  111.   + With LDBG=oldgo32 set:
  112.     * In non-dpmi mode:
  113.       go32 -d edebug32 app [args ...]
  114.     * In DPMI mode:
  115.       go32 -d ed32-dpm app [args ...]
  116.   + Without LDBG=oldgo32 set:
  117.     * In non-dpmi mode:
  118.       go32 -d edebug32 [-com_num] app [args ...]
  119.     * In DPMI mode:
  120.       go32 -d ed32-dpm [-com_num] app [args ...]
  121.  
  122. ** Without FSDB=oldgo32 set, the -com_num switch on the go32's
  123. command line (if there is one) is chosen rather than the "remote"
  124. parameter in the LDBG environment variable.
  125.  
  126. ------------------------------------------------------------------------------
  127. 5. Bugs
  128.  
  129.   - Known bug: The performance analyzer will NOT work properly under
  130. DPMI due to the different stack that DPMI provided to the timer
  131. interrupt handler.
  132.                      
  133.   - Unknown bugs: Please report to:
  134.  
  135.     ld@netrix.com
  136.